Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-AST-001 |
| Deskripsi | Master aset: daftar aset brand dengan filter kategori dan mode pengadaan, serta menambah, mengubah, melihat detail, mengarsipkan, dan memulihkan aset |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User dapat melihat daftar aset (nama, kategori aset, mode pengadaan)
- User dapat mencari nama aset dan memfilter kategori aset serta mode pengadaan
- User dapat menambah master aset (nama, satuan, kategori, mode pengadaan; untuk inventarisir/both juga memilih barang sumber)
- User dapat melihat detail dan mengubah data aset
- User dapat menghapus (arsip) aset dan memulihkannya dari arsip secara massal
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan daftar aset aktif dengan kolom nama aset, kategori aset, dan mode pengadaan |
| FR-02 | User dapat mencari nama aset dan memfilter berdasarkan kategori aset serta mode pengadaan |
| FR-03 | User dapat menambah master aset dengan nama, satuan, kategori aset, dan mode pengadaan |
| FR-04 | Jika mode pengadaan inventarisir atau pembelian & inventarisir, user wajib memilih barang sumber inventarisir |
| FR-05 | User dapat melihat detail dan mengubah master aset |
| FR-06 | User dapat menghapus aset (nonaktif) dan memulihkannya dari arsip secara massal |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Melihat dan memfilter daftar master aset |
| UC-02 | Menambah master aset |
| UC-03 | Melihat detail master aset |
| UC-04 | Mengubah master aset |
| UC-05 | Menghapus master aset |
| UC-06 | Memulihkan master aset dari arsip |
4. Use Case Scenario
UC-01 : Melihat dan memfilter daftar master aset
| Aktor | User brand dengan hak #aset |
| Deskripsi | User melihat daftar master aset |
| Prekondisi | User sudah login dan membuka brand |
| Alur utama | 1. User membuka menu Master, Aset, Master Aset. 2. Sistem menampilkan nama aset, kategori aset, dan mode pengadaan. 3. User mencari nama atau memilih filter kategori / mode pengadaan. 4. Sistem memuat ulang daftar. |
| Alur negatif | - Jika gagal memuat atau tidak ada hasil, daftar kosong / "Aset Kosong". |
| Bisnis rule | - Mode both ditampilkan sebagai "Pembelian & Inventarisir".- Pagination infinite scroll. |
| Postkondisi | Daftar aset tampil |
| Trigger | User membuka menu Master Aset |
| Kode FR | FR-01 FR-02 |
UC-02 : Menambah master aset
| Aktor | User brand dengan hak basic #aset |
| Deskripsi | User mendaftarkan master aset baru |
| Prekondisi | Kategori aset dan satuan tersedia |
| Alur utama | 1. User klik tambah. 2. User mengisi nama aset, satuan, kategori aset, mode pengadaan. 3. Jika mode inventarisir atau pembelian & inventarisir, user memilih barang sumber. 4. User klik Simpan. 5. Sistem menampilkan "Berhasil membuat aset". |
| Alur negatif | - Jika form tidak valid (field wajib kosong), simpan dibatalkan. - Jika simpan gagal, muncul pesan error dari server. |
| Bisnis rule | - Mode pengadaan: inventarisir, pembelian, atau both.- Untuk mode selain pembelian, payload menyertakan barang_id dan sku_id.- Satuan dikirim sebagai nama_satuan (mengacu master satuan). |
| Postkondisi | Master aset baru tersimpan |
| Trigger | User klik Simpan |
| Kode FR | FR-03 FR-04 |
UC-03 : Melihat detail master aset
| Aktor | User brand dengan hak view #aset |
| Deskripsi | User melihat detail master aset |
| Prekondisi | Aset sudah ada |
| Alur utama | 1. User memilih aksi Lihat pada baris aset. 2. Sistem memuat detail aset (dan barang terkait jika ada sku_id). |
| Alur negatif | - Jika gagal memuat, detail kosong. |
| Bisnis rule | - |
| Postkondisi | Detail aset tampil |
| Trigger | User klik Lihat |
| Kode FR | FR-05 |
UC-04 : Mengubah master aset
| Aktor | User brand dengan hak basic #aset |
| Deskripsi | User memperbarui master aset |
| Prekondisi | Aset sudah ada |
| Alur utama | 1. User membuka halaman ubah aset. 2. Sistem memuat data aset. 3. User mengubah nama, satuan, kategori, mode, dan barang (jika relevan). 4. User klik Simpan. 5. Sistem menampilkan "Berhasil update aset". |
| Alur negatif | - Jika form tidak valid, simpan dibatalkan. - Jika gagal, muncul pesan error dari server. |
| Bisnis rule | - Aturan barang sumber sama seperti UC-02. |
| Postkondisi | Master aset terbarui |
| Trigger | User klik Simpan |
| Kode FR | FR-05 FR-04 |
UC-05 : Menghapus master aset
| Aktor | User brand dengan hak basic #aset |
| Deskripsi | User menghapus / menonaktifkan master aset |
| Prekondisi | Aset ada di daftar aktif |
| Alur utama | 1. User klik hapus pada menu aksi. 2. Sistem meminta konfirmasi bahwa data yang dihapus tidak dapat diubah kembali. 3. User konfirmasi. 4. Sistem menampilkan "Berhasil Hapus Aset". |
| Alur negatif | - Jika server menolak, muncul pesan error dari server. |
| Bisnis rule | - Aset terhapus tampil di arsip (is_active: false). |
| Postkondisi | Aset tidak tampil di daftar aktif |
| Trigger | User konfirmasi hapus |
| Kode FR | FR-06 |
UC-06 : Memulihkan master aset dari arsip
| Aktor | User brand dengan hak archive #aset |
| Deskripsi | User mengaktifkan kembali aset dari arsip |
| Prekondisi | Ada aset tidak aktif |
| Alur utama | 1. User membuka Arsip. 2. User mencentang aset, klik Pulihkan Aset, konfirmasi. 3. Sistem menampilkan "Berhasil memulihkan Aset terpilih". |
| Alur negatif | - Jika gagal, muncul pesan error dari server. |
| Bisnis rule | - Pemulihan massal lewat bulk update is_active: true. |
| Postkondisi | Aset kembali aktif |
| Trigger | User klik pulihkan |
| Kode FR | FR-06 |
5. Data Flow Diagram
DFD-01
6. Sequence Diagram
SD-01 — UC-01 : Melihat dan memfilter daftar master aset
SD-02 — UC-02 : Menambah master aset
SD-03 — UC-03 : Melihat detail master aset
SD-04 — UC-04 : Mengubah master aset
SD-05 — UC-05 : Menghapus master aset
SD-06 — UC-06 : Memulihkan master aset dari arsip
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /aset | existing | - |
GET /aset/:id | existing | - |
POST /aset | existing | - |
PUT /aset/:id | existing | - |
DELETE /aset/:id | existing | - |
POST /aset/bulk-update | existing | - |
GET /kategori-aset | existing | - |
GET /satuan | existing | - |
GET /sku | existing | - |
GET /sku/:id | existing | - |